package com.lyh.notes.mapper;

import com.lyh.notes.model.entity.Category;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

@Mapper
public interface CategoryMapper {
    /**
     * 此方法负责接收一个Category对象，并执行插入操作，具体操作如将分类信息保存到数据库
     * 主要用于添加新的分类信息
     *
     */
    int insert(Category category);

    /**
     * 批量插入分类数据
     *
     */
    int insertBatch(@Param("categories") List<Category> categories);

    /**
     * 获取所有分类
     *
     */
    List<Category> categoryList();

    /**
     * 根据分类ID查找分类信息
     *
     */
    Category findById(Integer categoryId);

    /**
     * 批量通过分类ID查找分类信息
     * 此方法允许一次性查询多个分类的信息，通过提供一个分类ID列表作为参数
     *
     */
    List<Category> findByIdBatch(@Param("categoryIds") List<Integer> categoryIds);

    /**
     * 根据分类ID或父分类ID查找分类信息
     * 此方法旨在处理分类信息的查询，通过分类ID或父分类ID来过滤并返回匹配的分类对象列表
     *
     */
    List<Category> findByIdOrParentId(Integer categoryId);

    /**
     * 删除分类以及子分类
     *
     */
    int deleteById(Integer categoryId);

    /**
     * 批量删除分类
     * 通过多个分类ID一次性删除对应的分类信息
     *
     */
    int deleteByIdBatch(@Param("categoryIds") List<Integer> categoryIds);

    /**
     * 更新分类信息
     *
     */
    int update(Category category);
}
